Traffic Shadowing policy

Updated 22 July 2026

Traffic shadowing lets you asynchronously copy API traffic to another service by duplicating requests and sending them to the target URL. You can enrich the request with additional headers.

note

If you apply the Traffic Shadowing policy to an API, it takes precedence and ignores the max retry attempts you configure in execution settings.

Timing

On Request	On Response	On Request Content	On Response Content
X

Configuration

Property	Required	Description	Default	Example
target	yes	The shadow endpoint URL.
headers	no	A list of HTTP headers.

Example

{
  "traffic-shadowing": {
    "target": "http://boomitest.com/shadowApi",
    "headers": [
        {
            "name": "X-Boomi-Request-Id",
            "value": "{#request.id}"
        }
    ]
  }
}